<?xml version="1.0" encoding="utf-8" ?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="generator" content="Docutils 0.5: http://docutils.sourceforge.net/" />
<title>libtorrent Examples</title>
<meta name="author" content="Arvid Norberg, arvid&#64;rasterbar.com" />
<link rel="stylesheet" href="style.css" type="text/css" />
</head>
<body>
<div class="document" id="libtorrent-examples">
<h1 class="title">libtorrent Examples</h1>
<table class="docinfo" frame="void" rules="none">
<col class="docinfo-name" />
<col class="docinfo-content" />
<tbody valign="top">
<tr><th class="docinfo-name">Author:</th>
<td>Arvid Norberg, <a class="last reference" href="mailto:arvid&#64;rasterbar.com">arvid&#64;rasterbar.com</a></td></tr>
</tbody>
</table>
<div class="contents topic" id="table-of-contents">
<p class="topic-title first"><a name="table-of-contents">Table of contents</a></p>
<ul class="simple">
<li><a class="reference" href="#examples" id="id2" name="id2">examples</a><ul>
<li><a class="reference" href="#dump-torrent" id="id3" name="id3">dump_torrent</a></li>
<li><a class="reference" href="#simple-client" id="id4" name="id4">simple client</a></li>
<li><a class="reference" href="#make-torrent" id="id5" name="id5">make_torrent</a></li>
</ul>
</li>
</ul>
</div>
<div class="section">
<h1><a id="examples" name="examples">examples</a></h1>
<p>Except for the example programs in this manual, there's also a bigger example
of a (little bit) more complete client, <tt class="docutils literal"><span class="pre">client_test</span></tt>. There are separate
instructions for how to use it <a class="reference" href="client_test.html">here</a> if you'd like to try it. Note that building
<tt class="docutils literal"><span class="pre">client_test</span></tt> also requires boost.regex and boost.program_options library.</p>
<div class="section">
<h2><a id="dump-torrent" name="dump-torrent">dump_torrent</a></h2>
<p>This is an example of a program that will take a torrent-file as a parameter and
print information about it to std out:</p>
<pre class="literal-block">
#include &lt;iostream&gt;
#include &lt;fstream&gt;
#include &lt;iterator&gt;
#include &lt;iomanip&gt;

#include &quot;libtorrent/entry.hpp&quot;
#include &quot;libtorrent/bencode.hpp&quot;
#include &quot;libtorrent/torrent_info.hpp&quot;


int main(int argc, char* argv[])
{
        using namespace libtorrent;

        if (argc != 2)
        {
                std::cerr &lt;&lt; &quot;usage: dump_torrent torrent-file\n&quot;;
                return 1;
        }

        try
        {
                std::ifstream in(argv[1], std::ios_base::binary);
                in.unsetf(std::ios_base::skipws);
                entry e = bdecode(std::istream_iterator&lt;char&gt;(in)
                        , std::istream_iterator&lt;char&gt;());

                std::cout &lt;&lt; &quot;\n\n----- raw info -----\n\n&quot;;
                e.print(std::cout);

                torrent_info t(e);

                // print info about torrent
                std::cout &lt;&lt; &quot;\n\n----- torrent file info -----\n\n&quot;;
                std::cout &lt;&lt; &quot;nodes:\n&quot;;
                typedef std::vector&lt;std::pair&lt;std::string, int&gt; &gt; node_vec;
                node_vec const&amp; nodes = t.nodes();
                for (node_vec::const_iterator i = nodes.begin(), end(nodes.end());
                        i != end; ++i)
                {
                        std::cout &lt;&lt; i-&gt;first &lt;&lt; &quot;:&quot; &lt;&lt; i-&gt;second &lt;&lt; &quot;\n&quot;;
                }

                std::cout &lt;&lt; &quot;trackers:\n&quot;;
                for (std::vector&lt;announce_entry&gt;::const_iterator i
                        = t.trackers().begin(); i != t.trackers().end(); ++i)
                {
                        std::cout &lt;&lt; i-&gt;tier &lt;&lt; &quot;: &quot; &lt;&lt; i-&gt;url &lt;&lt; &quot;\n&quot;;
                }

                std::cout &lt;&lt; &quot;number of pieces: &quot; &lt;&lt; t.num_pieces() &lt;&lt; &quot;\n&quot;;
                std::cout &lt;&lt; &quot;piece length: &quot; &lt;&lt; t.piece_length() &lt;&lt; &quot;\n&quot;;
                std::cout &lt;&lt; &quot;info hash: &quot; &lt;&lt; t.info_hash() &lt;&lt; &quot;\n&quot;;
                std::cout &lt;&lt; &quot;comment: &quot; &lt;&lt; t.comment() &lt;&lt; &quot;\n&quot;;
                std::cout &lt;&lt; &quot;created by: &quot; &lt;&lt; t.creator() &lt;&lt; &quot;\n&quot;;
                std::cout &lt;&lt; &quot;files:\n&quot;;
                for (torrent_info::file_iterator i = t.begin_files();
                        i != t.end_files(); ++i)
                {
                        std::cout &lt;&lt; &quot;  &quot; &lt;&lt; std::setw(11) &lt;&lt; i-&gt;size
                                &lt;&lt; &quot; &quot; &lt;&lt; i-&gt;path.string() &lt;&lt; &quot;\n&quot;;
                }

        }
        catch (std::exception&amp; e)
        {
                std::cout &lt;&lt; e.what() &lt;&lt; &quot;\n&quot;;
        }

        return 0;
}
</pre>
</div>
<div class="section">
<h2><a id="simple-client" name="simple-client">simple client</a></h2>
<p>This is a simple client. It doesn't have much output to keep it simple:</p>
<pre class="literal-block">
#include &lt;iostream&gt;
#include &lt;fstream&gt;
#include &lt;iterator&gt;
#include &lt;exception&gt;

#include &lt;boost/format.hpp&gt;
#include &lt;boost/date_time/posix_time/posix_time.hpp&gt;

#include &quot;libtorrent/entry.hpp&quot;
#include &quot;libtorrent/bencode.hpp&quot;
#include &quot;libtorrent/session.hpp&quot;

int main(int argc, char* argv[])
{
        using namespace libtorrent;

        if (argc != 2)
        {
                std::cerr &lt;&lt; &quot;usage: ./simple_cient torrent-file\n&quot;
                        &quot;to stop the client, press return.\n&quot;;
                return 1;
        }

        try
        {
                session s;
                s.listen_on(std::make_pair(6881, 6889));

                std::ifstream in(argv[1], std::ios_base::binary);
                in.unsetf(std::ios_base::skipws);
                entry e = bdecode(std::istream_iterator&lt;char&gt;(in)
                        , std::istream_iterator&lt;char&gt;());
                s.add_torrent(torrent_info(e), &quot;&quot;);

                // wait for the user to end
                char a;
                std::cin.unsetf(std::ios_base::skipws);
                std::cin &gt;&gt; a;
        }
        catch (std::exception&amp; e)
        {
                std::cout &lt;&lt; e.what() &lt;&lt; &quot;\n&quot;;
        }
        return 0;
}
</pre>
</div>
<div class="section">
<h2><a id="make-torrent" name="make-torrent">make_torrent</a></h2>
<p>Shows how to create a torrent from a directory tree:</p>
<pre class="literal-block">
#include &lt;iostream&gt;
#include &lt;fstream&gt;
#include &lt;iterator&gt;
#include &lt;iomanip&gt;

#include &quot;libtorrent/entry.hpp&quot;
#include &quot;libtorrent/bencode.hpp&quot;
#include &quot;libtorrent/torrent_info.hpp&quot;
#include &quot;libtorrent/file.hpp&quot;
#include &quot;libtorrent/storage.hpp&quot;
#include &quot;libtorrent/hasher.hpp&quot;
#include &quot;libtorrent/file_pool.hpp&quot;

#include &lt;boost/filesystem/operations.hpp&gt;
#include &lt;boost/filesystem/path.hpp&gt;
#include &lt;boost/filesystem/fstream.hpp&gt;

using namespace boost::filesystem;
using namespace libtorrent;

void add_files(
        torrent_info&amp; t
        , path const&amp; p
        , path const&amp; l)
{
        path f(p / l);
        if (is_directory(f))
        {
                for (directory_iterator i(f), end; i != end; ++i)
                        add_files(t, p, l / i-&gt;leaf());
        }
        else
        {
                std::cerr &lt;&lt; &quot;adding \&quot;&quot; &lt;&lt; l.string() &lt;&lt; &quot;\&quot;\n&quot;;
                t.add_file(l, file_size(f));
        }
}

int main(int argc, char* argv[])
{
        using namespace libtorrent;
        using namespace boost::filesystem;

        path::default_name_check(no_check);

        if (argc != 4)
        {
                std::cerr &lt;&lt; &quot;usage: make_torrent &lt;output torrent-file&gt; &quot;
                        &quot;&lt;announce url&gt; &lt;file or directory to create torrent from&gt;\n&quot;;
                return 1;
        }

        try
        {
                torrent_info t;
                path full_path = complete(path(argv[3]));
                ofstream out(complete(path(argv[1])), std::ios_base::binary);

                int piece_size = 256 * 1024;
                char const* creator_str = &quot;libtorrent&quot;;

                add_files(t, full_path.branch_path(), full_path.leaf());
                t.set_piece_size(piece_size);

                file_pool fp;
                storage st(t, full_path.branch_path(), fp);
                t.add_tracker(argv[2]);

                // calculate the hash for all pieces
                int num = t.num_pieces();
                std::vector&lt;char&gt; buf(piece_size);
                for (int i = 0; i &lt; num; ++i)
                {
                        st.read(&amp;buf[0], i, 0, t.piece_size(i));
                        hasher h(&amp;buf[0], t.piece_size(i));
                        t.set_hash(i, h.final());
                        std::cerr &lt;&lt; (i+1) &lt;&lt; &quot;/&quot; &lt;&lt; num &lt;&lt; &quot;\r&quot;;
                }

                t.set_creator(creator_str);

                // create the torrent and print it to out
                entry e = t.create_torrent();
                libtorrent::bencode(std::ostream_iterator&lt;char&gt;(out), e);
                }
                catch (std::exception&amp; e)
        {
                std::cerr &lt;&lt; e.what() &lt;&lt; &quot;\n&quot;;
        }

        return 0;
}
</pre>
</div>
</div>
</div>
</body>
</html>
